PATENT 

5681-80300 

P9307 



"EXPRESS MAIL" MAILING LABEL 
NUMBER EL990142769US 
DATE OF DEPOSIT January 29, 2004 
I HEREBY CERTIFY THAT THIS PAPER OR 
FEE IS BEING DEPOSITED WITH THE 
UNITED STATES POSTAL SERVICE 
"EXPRESS MAIL POST OFFICE TO 
ADDRESSEE" SERVICE UNDER 37 C.F.R. 
§1.10 ON THE DATE INDICATED ABOVE 
AND IS ADDRESSED TO THE 
COMMISSIONER FOR PATENTS, BOX 
PATENT APPLICATION, P.O. Box 1450, 
Alexandria^VA 22313-145 




Derrick Brown 



MECHANISM FOR EXECUTING TEST SUITES WRITTEN FOR DIFFERENT 
HARNESSES UNDER ONE TEST EXECUTION HARNESS 



By: 

Olga Kuturianu and Victor Rosenman 



B. No€l Kivlin 

Meyertons, Hood, Kivlin, Kowert & Goetzel 
P.O. Box 398 
Austin, TX 78767-0398 



47858 



Ver. 47858S6.doc 



Mechanism for Executing Test Suites Written for 
Different Harnesses under One Test Execution Harness 

CROSS-REFERENCE TO RELATED APPLICATIONS 

[0001] This application is related to Application 

5 No. (STC File No. 47900), entitled "Automated Test Execution 
Framework with Central Management". 

BACKGROUND OF THE INVENTION 

1 . Field of the Invention . 

[0002] This invention relates to improvements in soft- 

10 ware and hardware design verification. More particularly, this 
invention relates to methods and systems for centrally managing 
the execution of multiple design verification test suites that 
•were written for use by different test harnesses or frameworks. 

2 . Description of the Related Art . 

15 [0003] The meanings of acronyms and certain terminology 

used herein are given in Table 1. The terms Sun, Sun Microsys- 
tems, Java, J2EE, J2ME, J2SE, and the Sun logo are trademarks 
or registered trademarks of Sun Microsystems, Inc., in the 
United States of America and other countries. All other company 

20 and product names may be trademarks of their respective compa- 
nies. A portion of the disclosure of this patent document con- 
tains material that is subject to copyright protection. The 
copyright owner has no objection to the facsimile reproduction 
by anyone of the patent document or the patent disclosure, as 

25 it appears in the Patent and Trademark Office patent file or 
records, but otherwise reserves all copyright rights whatso- 
ever. 
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Table 1 



API 


Application programming interface 


CLDC 


Connected, limited device configuration. CLDC is 
suitable for devices with 16/32-bit RISC/CISC 
microprocessors/controllers, having as little 
as 160 KB of total memory available. 


DTD 


Document type definition 


HTML 


Hypertext markup language 


JAXP 


Java API for XML Processing 


J2EE 


Java 2 Enterprise Edition 


J2ME 


Java 2 Micro Edition 


J2SE 


Java 2 Standard Edition 


JAD 


Java application descriptor 


JAR 


Java archive 


JTDS 


Java Device Test Suite Execution Framework 


MIDlet 


A MIDP application 


MIDP 


Mobile information device profile. A set of Java 
APIs, which, together with the CLDC, provides a 
complete J2ME application runtime environment 
targeted at mobile information devices. 


XML 


Extensible markup language 


XTRF 


XML test representation format 



[0004] Tools have been developed in recent years to aid 

in the design verification of hardware and software systems, 
5 for example software suites, hardware circuitry, and programma- 
ble logic designs. In order to assure that the design complies 
with its specifications, it is common to generate a large num- 
ber of input or instruction sequences to assure that the design 
operates as intended under a wide variety of circumstances. In 
10 general, test systems produce a report indicating whether tests 
have been passed or failed, and, in some cases may even indi- 
cate a module that is estimated to be faulty. 

[0005] Conventionally, test systems employing complex 

test suites employ a computer-implemented testing framework for 
15 computing devices, such as mobile information devices, and for 
software designed to run on such devices. A developer submits a 
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computing product under development, typically a computing de- 
vice or software that is designed to run on the device to the 
test system, which runs a selected battery of test programs on 
the product while monitoring its behavior. Each product under 
5 test requires an instance of an execution test harness, or the 
use of a stand-alone test execution API . 

[0006] In environments where testing of a product is 

ongoing, different aspects may be tested by different teams. As 
test results are evaluated, it is often necessary to revise the 

10 product under test, or to modify the test suites themselves. In 
such an environment, communicating such revisions to the dif- 
ferent testing teams, maintaining version control, synchroniza- 
tion among the teams, and generally coordinating the testing 
activities is a difficult management problem. Errors could re- 

15 suit in inappropriate testing, thus wasting valuable time and 
testing resources. Indeed, failure of coordination could result 
in the release of an inadequately tested product into the mar- 
ketplace. A related problem when many test suites are being 
concurrently executed is the effort of setting up each test 

20 suite with its own test harness and environment. Bundling the 
test harness with the test suite is not a good solution, as the 
effort in maintaining up-to-date versions becomes formidable as 
the number of concurrently operating test suites increases, and 
when the product or the test suites are frequently modified by 

25 different test teams. 

SUMMARY OF THE INVENTION 

[0007] In the above noted Application No. (STC File 

No. 47900), which is commonly assigned herewith, and herein in- 
corporated by reference, a test framework having a central re- 
30 pository and a management unit is disclosed. The central re- 
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pository contains available test suites and a single test exe- 
cution harness. An example of the latter is described in com- 
monly assigned Application No. 10/347,748, entitled "Generating 
Standalone MIDlets from a Testing Harness", which is herein in- 
5 corporated by reference. 

[0008] Using the management unit, a system administra- 

tor is enabled to control active versions of the various test 
suites, and their individual configurations. End users of this 
system install clients of the central repository, using a sys- 

10 tern-provided installer program. These clients constitute test 
harnesses. At the client, an execution script and a local con- 
figuration file are created. When the test harness is to be 
executed, it loads with all designated test suites being in- 
stalled, configured and ready for execution. The client always 

15 has the most updated versions of all test suites, as configured 
by the system administrator, using the management unit. This 
system operates from a single central location, without need 
for distributing local copies of the test harness or test 
suites, which could lead to loss of synchronization as updates 

20 are developed. 

[0009] The arrangement disclosed in the above noted Ap- 

plication No. (STC File No. 47900) does not fully address the 
situation in which the test framework is required to execute 
different test suites, which have been designed for different 

25 test harnesses. In order to execute these test suites, it has 
previously been necessary to implement each harness with indi- 
vidual configurations for each of the various test suites, and 
to separately execute the test suites. Alternatively, the test 
suites could be rewritten for one harness. Both solutions are 

30 time consuming and error prone. 
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[0010] A mechanism has been developed for transforming 

different test suites, written for different test harnesses, 
into a common XML format that can be read by one test harness. 
Thus, differences in the structure of the test suites are 
5 transparent to the test harness. To implement this mechanism, a 
component has been developed, which parses XML descriptors and 
provides an API to the test harness. 

[0011] The invention provides a method for testing com- 

puting devices, which is carried out by providing a plurality 
10 of suites of test programs on a server for execution by one or 
more computing devices that are coupled to the server, wherein 
the suites are represented in a plurality of formats. The 
method is further carried out by converting the suites to a 
common representation, processing the common representation in 
15 the server to define suites of converted test programs, and 
downloading the converted test programs from the server to the 
computing devices for execution. 

[0012] An aspect of the method includes controlling the 

execution of the converted test programs by the computing de- 
20 vices from the server, using no more than one test harness. 

[0013] In one aspect of the method conversion of the 

suites to the common representation is accomplished by convert- 
ing the suites to a common intermediate format, and thereafter 
converting the common intermediate format to a native format 
25 for use in processing the common representation in the server. 

[0014] According to another aspect of the method, the 

common intermediate format is a markup language. 

[0015] According to a further aspect of the method, the 

markup language is XML, and the suites are converted into XTRF 
30 files. 
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[0016] The invention provides a computer software prod- 

uct, including a computer-readable medium in which computer 
program instructions are stored, which instructions, when read 
by a computer, cause the computer to perform a method for test- 
5 ing computing devices, which is carried out by inputting a plu- 
rality of suites of test programs on a server for execution by 
one or more computing devices that are coupled to the server, 
wherein the suites are represented in a plurality of formats. 
The method is further carried out by converting the suites to a 

10 common representation, processing the common representation 
into suites of converted test programs, downloading the con- 
verted test programs to the computing devices for execution 
thereof by the computing devices, and controlling the execution 
of the converted test programs by the computing devices. 

15 [0017] The invention provides a server apparatus for 

testing computing devices, including a communication interface 
for coupling a plurality of the computing devices therewith, 
and a processor, which is adapted to provide a suite of test 
programs for execution by the computing devices, and to down- 

20 load the test programs via the communication interface for 
execution by the computing devices coupled thereto. The proces- 
sor is further adapted to control the execution by the comput- 
ing devices, wherein the test programs are initially input to 
the server apparatus in a plurality of formats. The processor 

25 is further adapted to convert the plurality of formats into a 
common format for download thereof to the computing devices. 

BRIEF DESCRIPTION OF THE DRAWINGS 

[0018] For a better understanding of the present inven- 

tion, reference is made to the detailed description of the in- 
30 vention, by way of example, which is to be read in conjunction 
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with the following drawings, wherein like elements are given 
like reference numerals, and wherein: 

[0019] Fig. 1 is a block diagram of a system for cen- 

trally managing the execution of multiple test suites, which 
5 have been written for different test harnesses; 

[0020] Fig. 2 is a high level functional block diagram 

of an implementation of a platform editor in the system of 
Fig. 1, in accordance with a disclosed embodiment of the inven- 
tion; 

10 [0021] Fig. 3 is a flow chart illustrating the trans- 

formation of a foreign test suite into a native test suite in 
accordance with a disclosed embodiment of the invention; and 

[0022] Fig. 4 is a block diagram illustrating the gen- 

eration and processing of a XTRF file according to a disclosed 

15 embodiment of the invention. 

DETAILED DESCRIPTION OF THE INVENTION 

[0023] In the following description, numerous specific 

details are set forth in order to provide a thorough under- 
standing of the present invention. It will be apparent to one 

20 skilled in the art, however, that the present invention may be 
practiced without these specific details. In other instances 
well-known circuits, control logic, and the details of computer 
program instructions for conventional algorithms and processes 
have not been shown in detail in order not to unnecessarily ob- 

25 scure the present invention. 

[0024] Software programming code, which embodies as- 

pects of the present invention, is typically maintained in per- 
manent storage, such as a computer readable medium. In a cli- 
ent/server environment, such software programming code may be 

30 stored on a client or a server. The software programming code 
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may be embodied on any of a variety of known media for use with 
a data processing system, This includes, but is not limited to, 
magnetic and optical storage devices such as disk drives, mag- 
netic tape, compact discs (CD's), digital video discs (DVD's), 
5 and computer instruction signals embodied in a transmission me- 
dium with or without a carrier wave upon which the signals are 
modulated. For example, the transmission medium may include a 
communications network, such as the Internet. 

System Architecture. 

10 [0025] Turning now to the drawings, reference is ini- 

tially made to Fig. 1, which is a high level block diagram of a 
system 10 for centrally managing the simultaneous or sequential 
execution of multiple test suites that have been written for 
different platforms for verifying different hardware and soft- 

15 ware, in accordance with a disclosed embodiment of the inven- 
tion. The heart of the system 10 is a central repository 12, 
which can reside on a local or a remote server, and which con- 
tains data structures necessary for multiple clients of the 
central repository 12 to perform testing simultaneously, or at 

20 different times. The central repository 12 holds data struc- 
tures that define platforms 14, test suites 16, an execution 
test harness 18, and an installer 20. The installer 20 creates 
a script for launching the framework. The script includes paths 
to binary files of the test execution framework. The binaries 

25 themselves are located in only one place, the central reposi- 
tory 12. Centrally locating the binary files is highly advanta- 
geous, as only one instance of each binary file need be up- 
dated. Furthermore, each user is guaranteed to see the most 
current version of the framework. Because distribution of local 

30 copies of the binaries is avoided, users need not be concerned 
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about having outdated software. The execution test harness 18 
may be implemented as a modification of the test framework 
"Java Device Test Suite" execution framework (JDTS) (ver- 
sion 1.0 or higher) , available from Sun Microsystems, Inc., 
5 Palo Alto, California, which employs MIDP. 

[0026] Alternatively, it. is possible to practice the 

invention using distributed data repositories, so long as they 
are accessible to a central management module. 

[0027] Typically the installation is packaged in an ar- 

10 chive, such as a JAR file. The system 10 is capable of being 
controlled by a single operator 22, using a client terminal 24. 
However, in many environments it is desirable that a superuser, 
or administrator 26 manage the central repository 12. This is 
done using a platform editor 28, which acts as a management 

15 unit. Using the platform editor 28, the administrator 26 is ca- 
pable of reconfiguring the platforms 14, test suites 16, execu- 
tion test harness 18, and installer 20. An end user 30 inter- 
acts with the central repository 12 via a client terminal 32. 
The end user 30 launches an execution package, which is first 

20 downloaded and installed from the central repository 12. The 
end user 30 and the terminal 32 may be co-located with the 
other components of the system 10, or alternatively may be lo- 
cated remotely and connected to the central repository 12 via a 
data network. Although only one instance of the end user 30 is 

25 shown, it will be understood that many end users can interact 
with the central repository 12 concurrently, or at different 
times, using the same or different platforms and the same or 
different test suites. The end user 30 and the terminal 32 are 
referred to hereinbelow as a client 34. 

30 [0028] In addition to handling native test suites, the 

system 10 is capable of managing foreign test suites, which 
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were originally written for previous versions of the test har- 
ness 18, or even other test harnesses, thus allowing such for- 
eign test suites to be recycled. This is accomplished using a 
conversion module 19, which converts test suites in diverse 
5 formats to a common intermediate representation, which is one 
or more XTRF files. A parser 21 then converts the XTRF files 
into a native format suitable for the test harness 18. The test 
suites 16 may be stored in the native format for immediate use 
by the test harness 18. Alternatively, they may be stored as 

10 XTRF files, and submitted to the parser 21 when needed by the 
test harness 18. Using this arrangement, any number of test 
programs and different test suites can be executed using no 
more than one test harness. 

[0029] The system 10 is suitable for use in many devel- 

15 opment environments, including MIDlet development using J2ME. 
It may be adapted to J2EE and J2SE environments using program- 
ming techniques known to the art. 

System - Functional Organization. 

[0030] Continuing to refer to Fig. 1, the central re- 

20 pository 12 contains test parameters, platform configuration 
parameters, framework parameters and the tests themselves. The 
end user 30 makes use of the central repository 12 in a "ses- 
sion". In an implementation of a session for a framework appli- 
cation in the execution state, contents of the central reposi- 

25 tory 12 are stored and loaded. The disclosure of the system im- 
plementation is common to the platform editor 28, which manages 
platforms using the central repository 12, and to other aspects 
of the execution framework, such as the installer 20. The in- 
staller 20 creates an execution script and local configuration 
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files. The execution test harness 18 is not downloaded. Its bi- 
nary files remain on the central repository 12. 

[0031] Reference is now made to Fig. 2, which is a high 

level functional block diagram of an implementation of the 
platform editor 28 (Fig. 1) in accordance with a disclosed em- 
bodiment of the invention. A class PlatformSessionManager 36 
has methods for loading and saving platforms and sessions. 

[0032] A class Platform 38 encapsulates all platform 

specific information. An instance of the class Platform 38 in- 
cludes such information as available test suites, and their re- 
spective properties, as well as other platform-specific infor- 
mation. The test suites and their properties are managed by a 
class TestSuitesManager 40. Platform-specific information is 
managed by a class EnvironmentView 42. Tests in the test suites 
can be excluded from performance by a class ExcludedTests- 
View 44. 

[0033] A class Session 46 encapsulates all information 

specified by the client 34 (Fig. 1) . Such client specific in- 
formation includes the basic properties of the test suites and 
the platform that applies to a particular session of the cli- 
ent 34. 

[0034] .The class Platform 38 and the class Session 46 

interact with the class TestSuitesManager 40, the class Envi- 
ronmentView 42, and the class ExcludedTest sView 44. 

[0035] The class TestSuitesManager 40 interacts with a 

table TestSuiteTable 48, which contains records of the differ- 
ent test suites, as indicated by a class TestSuiteTable 50. 

[0036] The class EnvironmentView 42 interacts with a 

table EnvironmentTable 52, which contains records of known 
platform environments, as indicated by a representative table 
EnvironmentRecord 54 . 
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[0037] The class ExcludedTestsView 44 interacts with a 

table ExcludedTestsTable 56, which contains records of excluded 
tests, as indicated by a representative class ExcludedTestsRe- 
cord 58. 

[0038] Records originating from the class 

TestSuiteTable 50, the table EnvironmentRecord 54, and the 
class ExcludedTestsRecord 58, are included in a class re- 
cord 60, and initially written to an interface table 62, before 
being ultimately transferred to an appropriate one of the table 
EnvironmentTable 52, the table EnvironmentRecord 54, or the ta- 
ble ExcludedTestsTable 56. 

[0039] A class XMLAccessManager 64 accepts requests 

from the class TestSuitesManager 40, the class Environment- 
View 42, and the class ExcludedTestsView 44 for read or write 
operations to and from the class Platform 38 and the class Ses- 
sion 46. The class XMLAccessManager 64 manages queues of read 
requests 66, write requests 68, and executes them sequentially. 

[0040] A class XMLAccess 70 contains a single access 

point to XML files that represent platforms and sessions. It 
has methods for read/write access to these XML files. 

[0041] Further details of the implementation of the 

platform editor 28 (Fig. 1) are disclosed in the above noted 
Application No. (STC File No. 47900). 

Test Suite Transformation - General. 

[0042] Reference is now made to Fig. 3, which is a flow 

chart illustrating the transformation of a foreign test suite, 
which has been written for a test framework other than the test 
harness 18 (Fig. 1), into a native test suite suitable for exe- 
cution using the test harness 18 and a suitable target device 
in accordance with a disclosed embodiment of the invention. The 
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target device could be the client terminals 24, 32, or devices 
(not shown) attached thereto. This is accomplished by first 
converting the foreign test suite into a common intermediate 
file, a XTRF file, which is a XML representation of a test 
5 suite. The XTRF file is then parsed so as to generate a test 
suite, which is native to the test harness 18. 

[0043] As shown in Listing 1, which is a DTD of the 

XTRF format, a XTRF file describes the content of a test suite, 
that is the various classes, and tests it contains, and the pa- 

10 rameters and external entities, which are used by the test 
suite. Other XML tags not shown in Listing 1 can optionally be 
included in a XTRF file. 

[0044] At initial step 76 a foreign test suite is se- 

lected. Next, at step 78 the foreign test suite is input into 

15 the conversion module 19, which is capable of converting dif- 
ferent foreign test suite formats into a common format, ex- 
pressed as one or more XTRF files. The details of the conver- 
sion module are disclosed in further detail hereinbelow. In 
some embodiments, the intermediate XTRF files may be stored as 

20 the test suites 16 (Fig. 1) . 

[0045] Next, at step 80, the XTRF files that were gen- 

erated in step 78 are submitted to the parser 21, which con- 
verts them into a native test suite representation 81 that is 
recognized by the test harness 18. Listing 2 is a Java code 

25 package that implements a parser for use in step 80. 

XTRF File Generation. 

[0046] Reference is now made to Fig. 4, which is a 

block diagram illustrating the generation and processing of a 
XTRF file according to a disclosed embodiment of the invention. 
30 A custom test suite 82 is typically written according to a cus- 
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torn API, which is different from the API of the Java Device 
Test Suite execution framework. Using the code fragment of 
Listing 3 a custom test suite representation can be scanned, 
and a XTRF generator 84 can be used to output a XTRF file 86 
5 representing the test suite. This is accomplished using a XTRF 
Generator API, details of which are presented hereinbelow 
in Appendix 1. 

XTRF Parsing. 

[0047] Continuing to refer to Fig. 4, the XML descrip- 

10 tors contained in the XTRF file 86 are parsed by a parser 88. 
The parser 88 provides an API to a test harness 90, which could 
be the test harness 18 (Fig. 1) . Using the parser 88, the test 
harness 90 is able to interpret and process the XTRF file 86. 
Details of this API are given hereinbelow in Appendix 2. 

1 5 Example . 

[0048] Continuing to refer to Fig. 4, a test prepared 

for a test harness other than the test harness 90 is presented 
in Listing 4, and is an example of a portion of the test 
suite 82, which in its present form is unacceptable to the test 
20 harness 90. The program shown in Listing 4 can be submitted to 
the XTRF generator 84 and the parser 88, as disclosed above. 
The final output of the parser 88 is acceptable to the test 
harness 90. 

[0049] It will be appreciated by persons skilled in the 

25 art that the present invention is not limited to what has been 
particularly shown and described hereinabove. Rather, the scope 
of the present invention includes both combinations and sub- 
combinations of the various features described hereinabove, as 
well as variations and modifications thereof that are not in 
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the prior art, which would occur to persons skilled in the art 
upon reading the foregoing description. 



COMPUTER PROGRAM LISTINGS 

[0050] Imported modules stated in program listings 

hereinbelow are components of JAXP (ver 1.2 or higher) or other 
standard Java API's of J2SE, both available from Sun Microsys- 
tems, Inc. 



10 



15 



20 



25 



<!D0CTYPE tes 
< ! ELEMENT 
< ! ATTLIST 
< ! ELEMENT 
< ! ATTLIST 
<! ATTLIST 
< ! ELEMENT 
<! ATTLIST 
< ! ELEMENT 
<! ATTLIST 
< ! ELEMENT 
< ! ATTLIST 
< ! ELEMENT 
< ! ATTLIST 
<ELEMENT 
< ! ATTLIST 

]> 



Listing 1 

tsuite [ 

group (class*)> 

group name CDATA #REQUIRED> 

class ( tes tease* ) > 

class name CDATA #REQUIRED> 

class package CDATA #REQUIRED> 

tes tease ( requiredclass* , property* , keyword* ) > 
testcase name CDATA #REQUIRED> 
requiredclass EMPTY> 

requiredclass name CDATA #REQUIRED> 
property EMPTY> 

property name CDATA #REQUIRED> 
keyword EMPTY> 

keyword name CDATA #REQUIRED> 
testsuite EMPTY> 
testsuite name CDATA #REQUIRED> 



30 



35 



40 



Listing 2 



package com . sun . xtrf . parser ; 



import j ava . io . * ; 

import org . w3c . dom . * ; 

import j avax . xml . parsers . DocumentBuilderFactory ; 

import j avax . xml . parsers . DocumentBuilder ; 

import org . xml . sax . SAXException ; 

import org . xml . sax . SAXParseException ; 

import com . sun . xml . tree . * ; 

import j ava . lang . reflect . * ; 
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20 



16 

import java.util.*; 

class XTRFParser 
{ 

private static GroupMap groupMap = new GroupMapO; 



10 { 



public void init() 

try 
{ 



15 //load all tags handlers classes from properties file 

Properties propertiesFile = new Properties () ; 



propertiesFile . load( this . getClass ( ) . getResourceAsStream 
( "xtrf .properties" ) ) ; 

//load tag handlers 
String str = properties 

File . getProperty( " tagHandlers . list" ) ; 

25 //get the name of the class 

StringTokenizer token = new StringTokenizer ( str , ";"); 

while ( token . hasMoreElements ( ) ) 
{ 

30 //create instance of each class 

Class els = Class . forName ( token . nextToken ()) ; 
els . newlnstance ( ) ; 

} 

} 

35 catch(Exception e) 

{ 

System . err , println ( "An exception has occurred 
during the class 
loading "+ 

4 0 e . getClass (). getName ( ) + ": " + e . getMessage ( ) ); 

e . printStackTrace ( System . err ) ; 

} 

} 

45 

/** 

* Parsing a XML document stored in a file. 

* */ 

TestGroup getRoot(File f) 
50 { 

Document doc ; 
Element el=null; 



P9309 



47858 



Ver. 47858S6.doc 



17 



try { 

DocumentBuilderFactory docBuilderFactory = Document 
BuilderFactory . newlnstance ( ) ; 
DocumentBuilder docBuilder = 

docBuilderFactory . newDocumentBuilder ( ) ; 

doc = docBuilder . parse (f); 

el = doc . getDocumentElement (); 
// normalize text representation 
el . normalize ( ) ; 

System . out . println ("Root element of the doc is " + 
doc . getDocumentElement ( ) . getNodeName ( ) ) ; 



} catch (SAXParseException err) { 

System . out . println ("** Parsing error" 
+ ", line " + err . getLineNumber () 
+ ", uri " + err . getSystemld ()); 
System . out . println ( " " + err . getMessage ()); 
// print stack trace as below 

} catch ( SAXException e) { 

Exception x = e . getException ( ) ; 

((x == null) ? e : x ) . printStackTrace (); 

} catch (Throwable t) { 

t . printStackTrace ( ) ; 

} 

//System . exit ( 0 ) ; 

groupMap . init ( ) ; 
return loadGroup ( el ) ; 
//additionalMap . init ( ) ; 

} 



private TestGroup loadGroup ( Element el) 

Class [ ] param={ Element . class , XTRFParser . class } ; 
Object [] obj = {el, new XTRFParser ()} ; 
TestGroup testGroup=null ; 
try 

{ 
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Class els = 

Class . forName ( ( String ) groupMap . get ( el . getNodeName ( ) ) ) ; 
Constructor constructor = 
els . getDeclaredConstructor (par am) ; 
5 testGroup= ( TestGroup ) constructor . newlnstance ( ob j ) ; 

NamedNodeMap attr=el . getAttributes ( ) ; 
processAttributes ( attr , testGroup) ; 

} 

catch (Exception e) 
10 { 

e . getMessage ( ) ; 

e . printStackTrace ( ) ; 

} 

return testGroup; 
15 } 

void processAttributes (NamedNodeMap attr , TestGroup testGroup) 
{ 

20 if (attr !=null) 

{ 

for(int j=0;j < attr . getLength ( ) ; j++) 
{ 

25 testGroup . putAttribute (attr . item( j ) . 

getNodeName ( ) , attr . item ( j ) . 
getNodeValue ( ) ) ; 

} 

} 

30 } 



35 



40 



45 



TestGroup! ] parse ( Element el, TestGroup parent) 
{ 

NodeList nodeList = el . getChildNodes ( ) ; 
LinkedList groups=new LinkedList( ) ; 
TestGroup testGroup=null ; 



for(int i=0 ; i < nodeList . getLength () ; i++) 
{ 

Node child = nodeList . item ( i ) ; 

String name = nodeList . item ( i ). getNodeName () ; 
if ( groupMap . has ( name ) ) 

{ 



try 

50 { 



Class[ ] param={ Element . class ,XTRFParser . class } ; 
Object[ ] obj={ child, this } ; 
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Class els = Class . forName (( String) 

groupMap . get ( name ) ) ; 
Constructor constructor = 

els . getDeclaredCons true tor (par am) ; 
testGroup=( TestGroup) constructor . newlnstance ( obj ) ; 
testGroup . addParent (parent ) ; 
NamedNodeMap attr=child . getAttributes ( ) ; 
processAt tributes ( attr , testGroup ) ; 

if(! (testGroup instanceof RequiredClassHandler ) ) 
groups . add( testGroup) ; 

} 

catch (Exception e ) 

{ 

e . getMessage ( ) ; 
. e . printStackTrace ( System . err ) ; 

} 



NodeList newLs = child . getChildNodes () ; 

if ( newLs ! =null ) 

{ 

for(int j=0; j < newLs . getLength ( ) ; j++) 
{ 

TestGroup newTestGroup = null; 

child = newLs . item ( j ) ; 

name = newLs . item ( j ) . getNodeName ( ) ; 



Registration regist = new Registration () ; 

if ( regist . has ( name ) ) 
{ 

TagHandler handler = regis t . get ( name ) ; 
handler . handleTag ( testGroup , child) ; 

} 

} 
} 

} 

TestGroup tGroups [ ] = new TestGroup [ groups . size ()] ; 

for(int i=0 ; i < groups . size () ; i++) 

( 
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20 



System . out . println ( i ) ; 

t Groups [ i ] = ( TestGroup ) groups . get ( i ) ; 



return tGroups ; 

} 



Listing 3 

15 import com . sun . xtrf . generator . * ; 

//this is the XTRF API package (xtrf api) 

import j ava . lang .reflect . Method ; 

import j ava . io . * ; 

import j ava . util . * ; 

20 import java.net.*; 

public class TckGenerator 
{ 

public static void main ( String [ ] args ) { 
25 TckGenerator gen = new TckGenerator () ; 

gen . generate ( args [ 0 ] , args [ 1 ] ) ; 

} 

//directory that containes test sources 
30 String sourceDir; 

Map hash = new HashMap( ) ; 
Map tmpHash =new HashMapO ; 
TagGenerator ancestor ; 
String [ ] globalArgs ; 

35 

/** 

* creates components that read tck test suite files 

* and perform generating 
40 **/ 

public void generate ( String outputDir , String inputDir) 

{ 

Xtrf Generator gen = new Xtrf Generator ( outputDir ) ; 
//part of the XTRF Generator API 
45 //it's used to start new xtrf document 

TagGenerator root = gen . createRoot ( " testsuite . xml" ) ; 
//create root of the document 
//call the document " testsuite . xml " 
50 ancestor=root ; 
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generateTree ( root , inputDir ) ; 
gen . f inishGenerating ( ) ; 

} 

5 /** 

* generates the xtrf file that will be read by the framework 

* * / 

private void generateTree ( TagGenerator root, String inputDir) 

{ • 
10 File testSuite = null; 

String logFileName = null; 

String outputFileName = "testsDescr.txt" ; 
int tfMode = 2; 

boolean needTestCases = true; 
15 File[ ] initialFiles = null; 

String prevDir=null ; 
TagGenerator groupRoot=root ; 
Map map = new HashMapO; 
testSuite = new File ( inputDir ) ; 

20 

//This method takes all tests related info from the tck 
// test suite and. converts it to xtrf format 
File f = new File ( testSuite , 4- File . separator + 

"classes" + File . separator + "shared" + File . separator + 
25 "testClasses . 1st" ) ; 

FilelnputStream stream = null; 

try 

{ 

30 stream = new FilelnputStream ( f ) ; 

} 

catch ( Exception e) 
{ 

e . getMessage ( ) ; 
35 e . printStackTrace ( ) ; 

} 

Buf f eredReader reader = new Buff eredReader ( new 
InputStreamReader ( stream) ) ; 
40 .String line; 

try 
{ 

while ((line = reader . readLine ())! =null ) 
45 { 

map . put ( line . substring ( 0 , line . indexOf 
( " " ) ) . trim ( ) , line . substring ( line . indexOf 
(" " )+1 , line . length( ) ) . trim( ) ) ; 

} 

50 } 

catch ( Exception e) 
{ 
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e . getMessage ( ) ; 

e . prints tackTrace ( ) ; 

} 

. try 

{ 

testSuite = new File ( inputDir ) ; 

testSuite = new File ( testSuite . getCanonicalPath ()) ; 
File testSuiteClasses = null; 
if ( needTestCases ) { 

if ( testSuite . isDirectory ( ) ) 

testSuiteClasses = new File ( testSuite , + 
File . separator + "classes"); 

else 

testSuiteClasses = new File ( testSuite . getParent () , 
+ File . separator + "classes"); 

if ( ! testSuiteClasses . exists ( ) ) 

TestFinderWrapper tf =null ; 

tf = new TestFinderWrapper () ; 

tf . setMode ( tf Mode ) ; 

tf . setRoot ( testSuite ) ; 

if ( logFileName != null) { 

log = new Pr intWri ter ( new Buf f eredWriter ( 
new FileWriter ( logFileName ))) ; 

tf . setVerif y ( true ) ; 

} 

TestFinderQueueWrapper tfq = new 

TestFinderQueueWrapper ( ) ; 
tfq. setTestFinder ( tf . getTestFinder ( ) ) ; 
tfq. setlnitialFiles (testSuite, initialFiles ) ; 
TestDescriptionWrapper td; 

while ((td = tfq.nextO) != null) { 

String [] keywords = td . getKeywords ( ) ; 

String dir = td . getRootRelativePath (). substring ( 0 , td . 
getRootRelativePath ( ) . indexOf ( td . getDir ( ) . getName ( ) ) 
+ td . getDir ( ) . getName ( ) . length ( ) ) ; 
root = createGroups (groupRoot , dir ,prevDir ) ; 
groupRoot=root ; 
prevDir =dir; 
if (needTestCases) { 

String executeClassName = 

td . get Parameter ( "executeClass" ) ; 
root = root . addChildTag( "class" , 
executeClassName . substring 
( executeClassName . last IndexOf 
( " . " ) +1 , executeClassName . length ( ) ) ) ; 
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//add info to xtrf using the api 
if ( executeClassName . indexOf (".")!=- 1 ) 
root . setAttribute 
5 ( "package" , executeClassName . substring 

( 0 , executeClassName . lastlndexOf ("."))); 

StringN testCases = getTestCases 
( td, testSuiteClasses , root) ; 
10 TagGenerator temp = null; 

if (testCases != null) { 

for (int i = 0; i < testCases . length ; i++) {. 

if ( ! testCases [i] . equals ( "getStatus" ) ) 
15 { 

temp=root ; 

root = root . addChildTag( " testcase" , 

testCases [ i ] ) ; 
createRequiredCl asses 

20 

(root, td. getRootRelativeURL( ) ,map) ; 

addKeywords ( root , keywords ) ; 
root=temp ; 

} 

25 } 

} 

} 



30 



50 



} 



} 

catch ( Exception e ) 

{ 

e . getMessage ( ) ; 
35 e . printStackTrace ( ) 

} 



40 private void addKeywords (TagGenerator root , String [ ] keywords) 
{ 

if ( keywords ! =null ) 

{ 

for (int i=0 ; i < keywords . length ; i++) 
45 { 

root . addChildTag ( " keyword" , keywords [ i ] ) ; 

} 

} 

} 



private void createRequiredClasses ( TagGenerator root, String 
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key, Map map) 
{ 

if (map . containsKey (key) ) 

i 

5 String values = ( String)map . get ( key ) ; 

StringTokenizer tok = new StringTokenizer (values , ","); 

while ( tok . hasMoreElements ( ) ) 

{ 

String t = tok . nextToken (). trim () ; 
10 root . addChildTag( " requiredclass " ,t ) ; 

} 

} 

TagGenerator createGroups ( TagGenerator root , 
String dir, String prevDir) 

15 { . 

StringTokenizer tokDir = new 
StringTokenizer ( dir , File . separator ) ; 
boolean f lag=f alse ; 
20 if (dir . equals (prevDir) ) 
return root; 
else if ( prevDir==null ) 

{ 

while ( tokDir . hasMoreTokens ( ) ) 
25 { 

String curr = tokDir . nextToken () ; 
root = root . addChildTag( "group" , curr) ; 
hash . put ( curr , root ) ; 

} 

30 } 

else 
{ 

StringTokenizer tokPrev = new 
StringTokenizer (prevDir , File . separator ) ; 
35 String prevRoot=null ; 

while ( tokDir . hasMoreTokens ( ) && tokPrev . hasMoreTokens ( ) ) 
{ 

String curr = tokDir . nextToken () ; 
String prev = tokPrev . nextToken () ; 
40 if ( (prevRoot==null ) && (! curr . equals ( prev )) ) 

{ 

root=ancestor; 
f lag=true ; 

} 

45 else if (! curr . equals (prev) && !flag) 

{ 

f lag=true ; 

root = ( TagGenerator ) hash . get (prevRoot ) ; 

} 

50 if (! curr . equals (prev) II flag) 

{ 

f lag=true ; 
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root = root . addChildTag ( "group" , curr) ; 
hash . put ( curr , root ) ; 

} 

prevRoot=prev ; 

5 } 

while ( tokDir . hasMoreTokens ( ) ) 
{ 

String curr = tokDir . nextToken () ; 
root = root . addChildTag ( "group" , curr ) ; 

10 } 

} 

f lag=f alse ; 
return root; 

} ■ 

15 String[] getTestCases ( TestDescriptionWrapper td, File 
classDir , TagGenerator root) { 

String executed a ssName = td . get Parameter ( "executeClass " ) ; 
if ( executeClassName == null) { 
20 System . err . println ( td . getRootRelativePath ( ) + 

" is apparently a runtime test but does not have an 
executeClass specified. " ) ; 
return null; 
} 

25 

PathClassLoaderWrapper loader = new 
PathClassLoaderWrapper (classDir . get Path ( ) ) ; 
try { 

Class c = loader . loadClass ( executeClassName ) ; 
30 if (isMultiTest (c, loader)) { 

String [ ] args = 

StringArrayWrapper . split ( td . getParameter ( "executeArgs" ) ) ; 
for (int i = 0; i < args. length; i++) { 

if ( args [ i ] . equals I gnoreCase ( " - TestCaselD" ) ) { 
35 // if -TestCaselD followed by ALL, drop out 

// and determine all test cases; otherwise, 
//get args up to next option (-*). 
int first = ++i ; 

if (first < args . length && args [ first ]. equals ( "ALL" ) ) 
40 break; 

while (i < args . length && ! args [ i ] . startsWith ( " - " ) ) 
i++; 

StringN testCases = new String[i - first]; 
System . arraycopy ( args , first, testCases, 0, 
45 testCases . length) ; 

return testCases; 

} 

} 

// no -TestCaselD found, or -TestCaselD ALL found 
50 // go use reflection to determine the test cases 

return getTestCases ( c , loader); 

} 



P9309 



47858 



Ver. 47858S6.doc 



26 

else 
{ 

String [] cases = new String[1]; 
cases [ 0 ]=" test easel " ; 
5 return cases ; 

} 

} 

catch (Exception e) { 
e . getMessage ( ) ; 
10 e.printStackTracet ) ; 

} 

return null; 
} 

15 private void setPackageName ( TagGenerator tag, String path) 
{ 

tag. setAttribute ( "package" ,path. substring( 1 ) ) ; 

} 

20 } 



25 



35 



40 



Listing 4 



import com . sun . xtrf . generator . * ; 

//this is XTRF API package - see Appendix 2 

import java . lang . reflect .Method; 

import j ava . io . * ; 

30 import java.util.*; 

import j ava . net . * ; 



public class TckGenerator 
{ 

public static void main ( String [ ] args ) { 

TckGenerator gen = new TckGenerator () ; 
gen . generate ( args [ 0 ] , args [ 1 ] ) ; 

} 



//directory that containes test sources 
String sourceDir; 

45 



Map hash = new HashMapO; 
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Map tmpHash =new HashMapC) ; 
TagGenerator ancestor; 
5 String [] globalArgs; 



10 /** 

* creates components that read tck test suite files and 

perform generating 

* * i 

public void generate ( String outputDir , String inputDir) 
15 { 

Xtrf Generator gen = new Xtrf Generator ( outputDir ) ; 
//part of the XTRF Generator API 

20 

//it's used to start new xtrf document 

TagGenerator root = 
gen . createRoot ( " testsuite . xml" ) ; 

//create root of the document - call the document 
2 5 //"testsuite . xml" 

ancestor=root ; 

generateTree ( root , inputDir ) ; 
gen . f inishGenerating ( ) ; 

30 



/** 

* generates the xtrf file that will be read by 

* the framework 
**/ 

private void generateTree ( TagGenerator root, 
String inputDir) 

{ 

File testSuite = null; 
String logFileName = null; 

String outputFileName = "testsDescr.txt"; 
int tfMode = 2 ; 

boolean needTestCases = true; 
File[] initialFiles = null; 
String prevDir=null ; 
50 TagGenerator groupRoot=root ; 

Map map = new HashMap( ) ; 



40 
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testSuite = new File ( inputDir ) ; 

//This method takes all tests related info from the 
//tck test suite and converts it to xtrf format 

File f = new File ( testSuite , + File . separator + "classes' 

+ File . separator + "shared" + File . separator + 
"testClasses . 1st" ) ; 



FilelnputStream stream = null; 
try 

{ 

stream = new FilelnputStream ( f ) ; 

15 } 

catch ( Exception e ) 
{ 

e . getMessage ( ) ; 

e . printStackTrace ( ) ; 

2 0 } 



Buf f eredReader reader = new Buff eredReader ( new 
25 InputStreamReader ( stream ) ) ; 
String line; 
try 

{ 

while ((line = reader . readLine ())! =null ) 
30 { 

map . put ( line . substring ( 0 , line . indexOf 
( " " ) ) . trim ( ) , line . substring ( line . indexOf 
(" " )+1 ,line.length( ) ) . trim( ) ) ; 

35 } 
} 

catch ( Exception e ) 

{ 

e . getMessage ( ) ; 
40 e . printStackTrace () ; 

} 



try 
45 { 

testSuite = new File ( inputDir ) ; 

testSuite = new File ( testSuite . getCanonicalPath ()) ; 

50 File testSuiteClasses = null; 

if (needTestCases) { 

if ( testSuite . isDi rectory ( ) ) 
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testSuiteClasses = new File ( testSuite , 
File . separator + "classes"); 

else 



testSuiteClasses = new File ( testSuite . getParent (),".. " + 
10 File . separator + "classes"); 

} 

if ( ! testSuiteClasses . exists ( ) ) 

} 

15 



TestFinderWrapper tf=null ; 

20 tf = new TestFinderWrapper ( ) 

tf . setMode ( tf Mode ) ; 
tf . setRoot ( testSuite ) ; 



25 if (logFileName != null) { 

log = new PrintWriter ( new Buf f eredWriter 

(new FileWriter ( logFileName ) ) ) ; 
tf . setVerif y ( true ) ; 

30 } 

TestFinderQueueWrapper tfq = new TestFinderQueueWrapper ( ) ; 

tfq. setTestFinder ( tf . getTestFinder ( ) ) ; 

tfq . setlnitialFiles ( testSuite , initialFiles ) ; 

35 

TestDescriptionWrapper td ; 

while ((td = tfq.next(J) != null) { 



40 

String [] keywords = td . getKeywords ( ) ; 

String dir = 
td . getRootRelativePath ( ) . substring 
4 5 ( 0 , td . getRootRelativePath ( ) . indexOf ( td . getDir ( ) . getName ( ) ) + 
td . getDir ( ) . getName ( ) . length ( ) ) ; 

root = createGroups ( groupRoot , dir , prevDir ) ; 
groupRoot=root ; 
50 prevDir =dir; 

if ( needTestCases ) { 
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String executeClassName = 

td . get Parameter ( * executeClass" ) ; 

5 root = root . addChildTag 

( "class" , executeClassName . substring 
(executeClassName . lastlndexOf ( " . " )+1 , 
executeClassName . length ( ) ) ) ; 
//add info to xtrf using the api 

10 

if ( executeClassName . indexOf (".")!=- 1 ) 

root . setAttribute ( "package" , executeClassName . substring 

( 0 , executeClassName . lastlndexOf ("."))); 
String[ ] testCases = getTestCases ( td , testSuiteClasses , root ) ; 
15 TagGenerator temp = null; 



if (testCases != null) { 
20 for (int i = 0; i < testCases . length; i++) { 

if ( ! testCases [ i ] . equals ( "get Status" ) ) 
{ 

temp=root ; 

25 root = root . addChildTag (" testcase" , testCases [ i ]) ; 

createRequiredClasses ( root , td. getRootRelativeURL ( ) ,map) ; 

addKeywords ( root , keywords ) ; 

root=temp; 

} 



30 



35 



40 



} 



} 



} 



catch (Exception e ) 

{ 

e . getMessage ( ) ; 
e. prints tackTracet ) ; 
45 } 

} 

private void addKeywords ( TagGenerator root , String [ ] keywords) 
50 { 

if ( keywords ! =null ) 

{ 
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for(int i=0 ; i < keywords . length ; i++) 
{ 

root . addChildTag ( " keyword" , keywords [ i ] ) ; 

} 

5 } 
} 



private void createRequiredClasses ( TagGenerator root , 
10 String key, Map map) 
{ 

if (map . containsKey ( key ) ) 

{ 

15 String values = ( String)map . get ( key ) ; 

StringTokenizer tok = new StringTokenizer (values , ","); 
while ( tok . hasMoreElements ( ) ) 

{ 

String t = tok . nextToken (). trim () ; 

20 

root . addChildTag ( " requiredclass " , t ) ; 

} 

} 

25 

TagGenerator createGroups ( TagGenerator root, String dir, 
String prevDir) 
{ 

StringTokenizer tokDir = new 
30 StringTokenizer ( dir , File . separator ) ; 

boolean f lag=f alse ; 
if ( dir . equals (prevDir ) ) 
return root; 
35 else if ( prevDir==null ) 

{ 

while ( tokDir . hasMoreTokens ( ) ) 

{ 

String curr = tokDir . nextToken () ; 

40 

root = root . addChildTag ( "group" , curr ) ; 
hash . put ( curr , root ) ; 

45 } 

} 

else 

{ 

50 StringTokenizer tokPrev = 

new StringTokenizer (prevDir , File . separator ) ; 
String prevRoot=null ; 
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while ( tokDir . hasMoreTokens ( ) && tokPrev . hasMoreTokens ( ) ) 
{ 

String curr = tokDir . nextToken () ; 
String prev = tokPrev . nextToken () ; 



if ( ( prevRoot==null ) && (! curr . equals (prev) ) ) 
{ 

10 root=ancestor ; 

f lag=true ; 
} 

else if (! curr . equals (prev) && iflag) 

{ 

15 flag=true; 

root = ( TagGenerator ) hash . get (prevRoot ) ; 

} 



if (! curr . equals (prev) !l flag) 
2 0 { 

f lag==true ; 
root = root . addChildTag ( "group" , curr ) ; 
hash . put ( curr , root ) ; 

25 } 

prevRoot=prev ; 

} 

30 while ( tokDir . hasMoreTokens ( ) ) 

{ 

String curr = tokDir . nextToken () ; 
root = root . addChildTag ( "group" , curr ) ; 

} 

35 

} 

f lag=f alse ; 
return root; 
} 

40 

String[ ] getTestCases ( TestDescript ionWrapper td, 
File classDir , TagGenerator root) { 

45 String executeClassName = td . getParameter ( " executeClass " ) ; 

if (executeClassName ===== null) { 

System . err . println ( td . getRootRelativePath ( ) + 
" is apparently a runtime test but does not have an 
50 executeClass specified."); 

return null; 
} 
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PathClassLoaderWrapper loader = 
new PathClassLoaderWrapper ( classDir . getPath ( ) ) ; 
try { 

Class c = loader . loadClass ( executeClassName ) ; 
if (isMultiTest ( c, loader)) { 

String [ ] args = 
StringArrayWrapper . split ( td . getParameter ( " executeArgs " ) ) ; 
for (int i = 0; i < args. length; i++) { 

if (args[i] . equalsIgnoreCase ( " -TestCaselD" ) ) { 

// if -TestCaselD followed by ALL, drop out and determine 
// alltest cases; 

// otherwise, get args up to next option (-*). 
int first = ++i ; 

if (first < args . length && args [ first ]. equals ( "ALL" ) ) 
break ; 

while (i < args. length && ! args [ i ] . startsWith ( " - " ) ) 
i++; 

String[] testCases = new String[i - first]; 
System. arraycopy (args , first, testCases, 0, 

testCases . length) ; 
return testCases; 

} 

} 

// no -TestCaselD found, or -TestCaselD ALL found 
// go use reflection to determine the test cases 
return getTestCases ( c , loader); 
} 

else 

{ 

String[] cases = new String[1]; 
cases [ 0 ]=" test easel " ; 
return cases; 

} 

} 

catch (Exception e) { 
e . getMessage ( ) ; 
e . printStackTrace ( ) ; 

} 

return null; 
} 



private void setPackageName ( TagGenerator tag. 
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String path) 
{ 

tag . set At tribute ( "package" , path . substring ( 1 ) ) ; 

> 

5 } 
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Appendix 1 

XTRF Generator 
Description 

5 This document is generated from sample source code and HTML 
files with examples of a wide variety of Java language 
constructs: packages, subclasses, subinterfaces, nested 
classes, nested interfaces, inheriting from other packages, 
constructors, fields, methods, and so forth. 

10 

Here is an example of the tag "@link 

com. package . SubClass#publicStaticMethod ( ) " ( shown without curly 
braces) in a sentence: {@link 

com. package . SubClass#publicStaticMethod ( ) }. Note that the 
15 reference must be fully qualified when inside an overview file. 
Any label (the second argument in ©link) would be ignored by 
the MIF Doclet. 

Here is an image: 

20 

H2 Heading 

This is text below the H2 heading. 

H3 Heading 
25 This is text below the H3 heading. 

H4 Heading 

This is text below the H4 heading. 
30 H5 Heading 
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This is text below the H5 heading. 
H6 Heading 

This is text below the H6 heading. 
5 The following is a sample table. 



first item 


This is the description of the first item. 
It is long enough to wrap to the next line. 


Second Item 


This is the description of the second item. 
It is long enough to wrap to the next line. 


last Item 


This is the description of the last item. 
It is long enough to wrap to the next line. 



10 Package Summary 

Package com. sun . xtrf . generator 

Class Summary 

Classes 

TagGenerator : This class provides user with ability to create 
15 xml tag with any given name and attributes. 

TagLinkedGenerator Title: xtrf Generator Description: This 
package is an API for generating xtrf formatted files. 

20 Xtrf Generator : This class provides an engine for xml document 
generating . 

TagGenerator com. sun . xtrf . generator 
TagGenerator ( ) 
2 5 com. sun . xtrf . generator 
TagGenerator 
Declaration 
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public class TagGenerator 

j ava . lang . Ob j ect 

I 

+--com. sun . xtrf . generator . TagGenerator 

5 

Direct Known Subclasses: TagLinkedGenerator 
Description 

This class provides user with ability to create xml tag with 
any given name and attributes. 

10 

Member Summary 
Constructors 
TagGenerator ( ) 

TagGenerator (Element el, Document doc) 

15 

Methods 

TagGenerator addChildTag ( j ava . lang . String tag) 
This method allows to add child tag to this tag. 

20 TagGenerator addChildTag ( j ava . lang . String tag, j ava . lang . String 
name) 

This method allows to add child tag to this tag. 

void setAttribute ( j ava . lang . String key, j ava . lang . String value) 
25 This method allows to set attributes to this tag. 

void setText (java . lang. String text) 

This method allows to add text node to this tag. 

30 

Inherited Member Summary 
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Methods inherited from class Object: 

clone (), equals (Obj ect ) , finalized , getClassO, hashCode(), 

notify ( ) , notif yAll ( ) , 

toString ( ) , wait ( ) , wait ( ) , wait () 

5 

Constructors 
TagGenerator ( ) 
public TagGenerator ( ) 

10 

TagGenerator (Element, Document) 

public TagGenerator (com. sun. xtrf . generator. Element el, 
com. sun . xtrf . generator . Document doc) 
Parameters : 
15 el - current node in the DOM tree 
doc - current document 

Methods 

addChildTag (String) 
2 0 public com. sun. xtrf . generator . TagGenerator 

addChildTag ( java. lang. String tag) 

This method allows to add child tag to this tag. 
Parameters : 
25 tag - name of the tag 

Returns: the object that represents child tag 

addChildTag (String, . String) 

public com. sun . xtrf . generator . TagGenerator 

30 

addChildTag (java. lang. String tag, j ava . lang . String name) 
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This method allows to add child tag to this tag. 
Parameters : 
tag - name of the tag 
name - value of the name attribute 
5 Returns: the object that represents child tag 

setAttribute (String, String) 

public void setAttribute ( j ava . lang . String key, j ava . lang . String 
value) 

10 This method allows to set attributes to this tag. 
setText (String) 

public void setText ( j ava . lang . String text) 

This method allows to add text node to this tag. 

15 



com. sun . xtrf . generator 
TagLinkedGenerator 
20 Declaration 

public class TagLinkedGenerator extends TagGenerator 

j ava . lang . Ob j ect 

I 

+ ~com. sun . xtrf . generator . TagGenerator 
25 | 

+— com. sun . xtrf . generator . TagLinkedGenerator 
Description 

Title: xtrf Generator Description: This package is an API for . 
generating xtrf formatted files. It provides classes 
30* for tag and atributes generating, and engine that creates files 
from generated tags Copyright: Copyright (c) 2001 
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Company: Sun Microsystems 

Member Summary 
Constructors 
5 TagLinkedGenerator ( ) 

TagLinkedGenerator (Element el, XmlDocument doc) 

Methods 

TagGenerator addChildTag ( j ava . lang . String tag) 
10 This method allows to add child tag to this tag. 

TagGenerator addChildTag ( j ava . lang . String tag, j ava . lang . String 
name) 

15 Inherited Member Summary 

Methods inherited from class Object 

clone () , equals (Obj ect ) , finalized , getClass(), hashCode ( ) , 

notify (), notifyAll(), 

toString ( ) , wait ( ) , wait ( ) , wait ( ) 

20 

Methods inherited from class TagGenerator 
setAttribute (String, String) , setText (String) 

Constructors 
25 TagLinkedGenerator ( ) 

public TagLinkedGenerator ( ) 

TagLinkedGenerator (Element, XmlDocument) 

public TagLinkedGenerator (com. sun . xtrf . generator . Element el, 
30 com. sun . xtrf . generator . XmlDocument doc) 
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Methods 

addChildTag (String) 

public com. sun . xtrf . generator . TagGenerator 

5 

addChildTag ( java. lang. String tag) 
this method allows to add child tag to this tag 
Overrides: addChildTag in class TagGenerator 
Returns: the object that represents child tag 

10 

addChildTag (String, String) 

public com. sun . xtrf . generator . TagGenerator 

addChildTag (java. lang. String tag, java. lang. String name) 
15 Description copied from class: 

com. sun. xtrf. generator. TagGenerator 

This method allows to add child tag to this tag. 

Overrides: addChildTag in class TagGenerator 

20 XtrfGenerator 
Declaration 

public class XtrfGenerator 

j ava . lang . Ob j ect 

I 

25 + — com. sun. xtrf . generator .XtrfGenerator 
Description: 

This class provides an engine for xml document generating. 
Constructors 

30 

XtrfGenerator (String) 
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public Xtrf Generator (java . lang. String outputPath) 
Parameters: 

outputPath - directory that will contain generated files 
5 Member Summary 
Constructors 

XtrfGenerator (java. lang. String outputPath) 
10 Methods 

TagGenerator createRoot (java. lang. String f ileName) 

This method creates tag that represents root of the xtrf 

document from given name of the tag. 

15 void f inishGenerating ( ) 

This method should be called in order to finish generation of 

the xtrf files. 

static 

j ava . lang . String 
20 getOutputPath ( ) 

Inherited Member Summary 

Methods inherited from class Object 

clone (), equals (Object ) , finalize (), getClassO, hashCode(), 
25 notify (), notifyAll(), 

toStringO, wait ( ) , wait ( ) , wait () 
com. sun . xtrf . generator XtrfGenerator 
createRoot (String) 

30 Methods 

createRoot (String) 
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public com. sun . xtrf . generator . TagGenerator 
createRoot { j ava . lang . String f ileName) . 

This method creates tag that represents root of the xtrf 
document from given name of the tag. 
5 Returns: TagGenerator object that represents this tag's node in 
the tree 

f inishGenerating ( ) 
public void f inishGenerating ( ) 
10 This method shoild be called in order to finish generating of 
the xtrf files. 

getOutputPath ( ) 

public static j ava . lang . String getOutputPath ( ) 
15 Returns : directory for files storage 
Xtrf Generator com. sun . xtrf . generator 
getOutputPath ( ) 
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Appendix 2 

Description 

This document is generated from sample source code and HTML 
5 files with examples of a wide variety of Java language 
constructs: packages, subclasses, subinterf aces , nested 
classes, nested interfaces, inheriting from other packages, 
constructors, fields, methods, and so forth. 

10 XTRF Parser 

com. sun. xtrf .parser 
Package Summary 

Package 
15 com. sun. xtrf . parser 
Class Summary 
Interfaces 

TagHandler This is an interface for all xtrf tag handlers that 
will be implemented it processes tag information and attributes 
20 for further usage. 

Classes 

Group: This class represents group entity which is a node on 
the package tree. 

25 

KeywordsHandler : This class handles a requiredclass tag that 
also represents test group. 

LinkHandler: This class handles a link tag in xtrf format. 

30 
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PropertiesHancller : This class handles a requiredclass tag that 
also represents test group. 

RequiredClassHandler : This class handles requiredclass tag that 
5 also represents a test group. 

SourceHandler: This class handles a source tag in a xtrf 
document . 

10 TestCase: TestCase objects embody the name of the test case and 
the information about this test case. The list of the objects 
is extracted from XTRF format files by the appropriate XML 
parser (files that contain all necessary information about test 
parameters and execution in XML format) . 

15 

TestClass: TestClass objects embody the name of the class and 
the required information about the test class. The list of the 
objects is extracted from XTRF format files by the appropriate 
XML parser (files that contain all necessary information about 
20 test parameters and execution in XML format) . 

TestGroup: This abstract class represents an abstract entity 
which is one of TestSuite, TestPackage, TestClass or TestCase. 
It provides information about the children of this TestGroup 
25 and value of the name attribute. It also provides a client 

programmer with the ability to add its own tag to the format 
and class that handles this tag (This class should implement 
the TagHandler interface) . 

TestPackage. The TestPackage object embodies the name of the 
30 testpackage and needed information. The list of. the objects is 
extracted from XTRF format files by the appropriate XML parser 



P9309 



47858 



Ver. 47858S6.doc 



4 6 

(files that contain all necessary information about test 
parameters and execution in XML format) . 

TestSuite: TestSuite objects embody the name of the testsuite 
5 and information about their children. The list of the objects 
is extracted from XTRF format files by the appropriate XML 
parser (files that contain all necessary information about test 
parameters and execution in XML format) . 

10 XtrfApi This is an API class for the XTRF parser that contains 
methods that allow user to use this parser as a stand-alone 
application. 

Group 
15 Declaration 

public class Group extends TestGroup 

j ava . lang . Ob j ect 
f 

2 0 + — com. sun . xtrf . parser . TestGroup 
I 

+--com. sun . xtrf . parser . Group 
Description 

25 This class represents group entity which is a node on the 
package tree. 

Inherited Member Summary 
Fields inherited from class TestGroup 
30 attributesMap, el, keywords, parser 
Methods inherited from class Object 
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clone (), equals (Object) , finalize (), getClassO, hashCode ( ) , 
notify (), notifyAllO, toStringO, wait(), wait () , wait ( ) 

Methods inherited from class TestGroup 
5 addTagHandler (String, TagHandler) , getChildren ( ) , 
getKeywords ( ) , getName ( ) , getProperties ( ) , 
getRequiredClasses ( ) , getSource ( ) 

KeywordsHandler 
10 Declaration 

public class KeywordsHandler extends TestGroup implements 

TagHandler 

j ava . lang . Ob j ect 

I 

15 +— com. sun . xtrf . parser . TestGroup 
I 

+— com. sun . xtrf . parser . KeywordsHandler 
All Implemented Interfaces: TagHandler 

20 Description 

THis class handles a requiredclass tag that also represents a 
test group. 

Member Summary 
25 Constructors 

KeywordsHandler ( ) 

Methods 

void handleTag (TestGroup group, org.w3c.dom.Node node) 
30 This method handles requredclass tag and its children. 
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Inherited Member Summary 
Fields inherited from class TestGroup 
attributesMap, el, keywords, parser 
Methods inherited from class Object 
5 clone (), equals (Ob j ect ) , finalize (), getClass(), hashCode(), 
notify (), notifyAll(), toStringt), wait(), wait ( ) , wait() 

Methods inherited from class TestGroup 
addTagHandler (String, TagHandler) , getChildren ( ) , 
10 getKeywords ( ) , getName ( ) , getProperties ( ) , 
getRequiredClasses ( ) , getSource ( ) 

Constructors 
KeywordsHandler ( ) 
15 public KeywordsHandler ( ) 

Methods 

handleTag (TestGroup, Node) 

20 public void handleTag (com. sun. xtrf .parser . TestGroup group, 
org . w3c . dom . Node node ) 

This method handles requredclass tag and its children. 
Specified By: handleTag in interface TagHandler 

25 

LinkHandler 
Declaration 

public class LinkHandler implements TagHandler 
j ava . lang . Ob j ect 
30 | 

+— com. sun . xtrf . parser . LinkHandler 
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All Implemented Interfaces: TagHandler 
Description 

5 This, class handles link tag in xtrf format 
Constructors 
LinkHandler ( ) 
public LinkHandler ( ) 

10 Methods 

handleTag (TestGroup, Node) 

public void handleTag ( com. sun . xtrf . parser . TestGroup group, 
org. w3c . dom. Node node) 

15 Member Summary 
Constructors 
LinkHandler ( ) 

Methods 

20 void handleTag (TestGroup group, org . w3c . dom.-Node node) 
This method handles link tag. 

Inherited Member Summary 
Methods inherited from class Object 
25 clone (), equals (Object ) , finalized , getClass(), hashCode ( ) , 
notify (), notifyAlM), toStringO, wait ( ) , wait ( ) , wait() 

LinkHandler com. sun . xtrf . parser 
handleTag (TestGroup, Node) 

30 

This method handles link tag 
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Specified By: handleTag in interface TagHandler 



PropertiesHandler 
Declaration 

5 public class PropertiesHandler extends TestGroup implements 
TagHandler 

j ava . lang . Ob j ect 
I 

10 + — com. sun . xtrf . parser . TestGroup 
I 

+--com. sun . xtrf . parser . PropertiesHandler 

All Implemented Interfaces: TagHandler 
15 Description 

This class handles requredclass tag that also represents test 
group. 

Member Summary 
20 Constructors 

PropertiesHandler ( ) 
Methods 

void handleTag (TestGroup. group, org.w3c.dom.Node node) 
This method handles requiredclass tag and its children. 

25 

Inherited Member Summary 

Fields inherited from class TestGroup 

attributesMap, el, keywords, parser 

30 Methods inherited from class Object 
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clone (), equals (Object ) , finalize (), getClass ( ) , hashCode ( ) , 
notify (), notifyAHO, toString ( ) , . wait ( ) , wait ( ) , wait ()' 

Methods inherited from class TestGroup 
5 addTagHandler (String, TagHandler ) , getChildren ( ) , 
getKeywords ( ) , getName ( ) , getProperties ( ) , 
getRequiredClasses ( ) , getSource ( ) 

Constructors 
10 PropertiesHandler ( ) 

public PropertiesHandler ( ) 
Methods 

handleTag (TestGroup, Node) 

public void handleTag ( com. sun . xtrf . parser . TestGroup group, 
15 org.w3c.dom.Node node) 

This method handles requiredclass tag and its children. 
Specified By: handleTag in interface TagHandler 

RequiredClassHandler ' 
20 Declaration 

public class RequiredClassHandler extends TestGroup implements 
TagHandler 

java. lang.. Object 
25 | 

+— com. sun. xtrf .parser . TestGroup 

I ' 

+ — com. sun . xtrf . parser . RequiredClassHandler 

30 All Implemented Interfaces: TagHandler 
Description 
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This class handles requiredclass tag that also represents a 
test group. 

Member Summary 
5 Constructors 

RequiredClassHandler ( ) 

Methods 

void handleTag (TestGroup group, org . w3c . dom. Node node) 
10 This method handles requredclass tag and its children. 

Inherited Member Summary 
Fields inherited from class TestGroup 
attributesMap, el, keywords, parser 
15 Methods inherited from class Object 

clone (), equals (Object ) , finalize (), getClass(), hashCode ( ) , 
notify (), notifyAll(), toString ( ) , wait ( ) , wait(), wait() 

Methods inherited from class TestGroup 
20 addTagHandler (String, TagHandler) , getChildren ( ) , 
getKeywords ( ) , getName ( ) , getProperties ( ) , 
getRequiredClasses ( ) , getSource ( ) 

Constructors 
25 RequiredClassHandler ( ) 

public RequiredClassHandler ( ) 

Methods 

handleTag (TestGroup, Node) 

30 
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public void handleTag (com. sun . xtrf . parser . TestGroup group, 
org . w3c . dom. Node node) 

This method handles requredclass tag and its children. 
Specified By: handleTag in interface TagHandler 

5 

SourceHandler 
Declaration 

public class SourceHandler implements TagHandler 
10 java. lang. Object 
I 

+— com. sun . xtrf . parser . SourceHandler 
All Implemented Interfaces: TagHandler 

15 Description 

This class handles source tag in xtrf document 

Constructors 
SourceHandler ( ) 
20 public SourceHandler ( ) 

Methods 

handleTag (TestGroup, Node) 

public void handleTag ( com. sun . xtrf . parser . TestGroup group, 
2 5 org . w3c . dom. Node node) 

Member Summary 
Constructors 
SourceHandler ( ) 

30 

Methods 
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void handleTag (TestGroup group, org . w3c . dom. Node node) 
This method handles source tag. 

Inherited Member Summary 
5 Methods inherited from class Object 

clone (), equals (Object) , finalize (), getClassO, hashCode ( ) , 
notify (), notif yAll ( ) , toString ( ) , wait () , wait () y wait () 

Constructors 
10 SourceHandler ( ) 

public SourceHandler ( ) 
Methods 

handleTag (TestGroup, Node) 



15 public void handleTag (com. sun . xtrf . parser . TestGroup group, 
org . w3c . dom. Node node) 

This method handles source tag. 

Specified By: handleTag in interface TagHandler. 

20 

TagHandler 
Declaration 

public interface TagHandler 
25 All Known Implementing Classes: KeywordsHandler , LinkHandler , 
SourceHandler, Proper tiesHandler , RequiredClassHandler 

Description 

This is an interface for all xtrf tag handlers that will be 
30 implemented it processes tag information and attributes for 
further usage. 
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Methods 

handleTag (TestGroup, Node) 

public void handleTag (com. sun. xtrf .parser . TestGroup group, 
5 org.w3c.dom.Node node) 
Parameters: 

group - test group to which this tag belongs 
node - node that represents this tag 

10 Member Summary 
Methods 

void handleTag (TestGroup group, org . w3c . dom . Node node) 

TestCase 
15 Declaration 

public class TestCase extends TestGroup 

j ava . lang . Ob j ect 

I 

+— com. sun . xtrf . parser . TestGroup 
20 | 

•f— com. sun . xtrf . parser . TestCase 
Description 

TestCase objecta embody the name of the test case and the 
25 information about this test case. The list of the objects is 
extracted from XTRF format files by the appropriate XML 
parser (files that contain all necessary information about test 
parameters and execution in XML format) . 

30 Member Summary 
Methods 
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j ava . lang . String get JavaName ( ) 

Gets java name of this test case that consists from package 
name + class name + test case name. 

5 j ava . util . Properties get Properties ( ) 

Inherited Member Summary 

Fields inherited from class TestGroup 

attributesMap, el, keywords, parser 

10 

Methods inherited from class Object 

clone (), equals (Object ) , finalize (), getClass () , hashCode(), 
notify (), notifyAll(), toString ( ) , wait () , wait ( ) , wait ( ) 

15 Methods inherited from class TestGroup 

addTagHandler (String, TagHandler) , getChildren ( ) , 
getKeywords ( ) , getName ( ) , getRequiredClasses ( ) , getSource ( ) 

Methods 
2 0 get JavaName ( ) 

public j ava . lang . String get JavaName ( ) 

Gets java name of this test case that consists from package 
name + class name + test case name. 

25 getProperties ( ) 

public j ava . util . Properties getProperties ( ) 

Description copied from class: com. sun . xtrf . parser . TestGroup 
This method returns this group's properties as they appear in 
XTRF. 

30 Overrides: getProperties in class TestGroup 
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TestClass 
Declaration 

public class TestClass extends TestGroup 
j ava . lang . Ob j ect 

5 I 

+ — com. sun . xtrf . parser . TestGroup 
I 

+— com. sun. xtrf .parser . TestClass" 
10 Description 

TestClass objects embody the name of the class and the required 
information about the test class. The list of the objects is 
extracted from XTRF format files by the appropriate XML 
parser (files that contain all necessary information about test 
15 parameters and execution in XML format) . 

Inherited Member Summary 
Fields inherited from class TestGroup 
attributesMap, el, keywords, parser 
20 Methods inherited from class Object 

clone ( ) , " equals (Object) , finalize ( ) , get Class ( ) , hashCode ( ) , 
notify (), notifyAll(), toStringO, wait ( ) , wait ( ) , wait() 

Methods inherited from class TestGroup 
25 addTagHandler (String, TagHandler ) , . getChildren ( ) , 
getKeywords ( ) , getName ( ) , getProperties ( ) , 
getRequiredClasses ( ) getSourceO 



30 TestGroup 

Declaration 
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public abstract class TestGroup 

java . lang . Object 

I 

+--com. sun.xtrf . parser. TestGroup 

5 

Direct Known Subclasses: Group, KeywordsHandler , 
PropertiesHandler, RequiredClassHandler , TestCase, TestClass, 
TestPackage, TestSuite 

10 Description 

This abstract class represents an abstract entity which is 
either TestSuite, TestPackage, . TestClass or TestCase. It 
provides information about the children of this TestGroup and 
value of the name attribute. It also provides a client 

15 programmer with the ability to add its own tag to the format 
and class that handles this tag (This class should implement 
TagHandler interface) 

Member Summary 
20 Fields 

protected 
java . util .Map 

attribute sMap 

25 

protected Element el 

current node in the parsed tree 

protected java . util . LinkedList 

30 

keywords 
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protected XTRFParser parser 

Instance of the class that handles parsing. 

Constructors 
5 TestGroupO 
Methods 

void addTagHandler (java . lang. String tagName, TagHandler 
handler) 

Allows adding xml tag and class that handles it to the parser. 

10 

TestGroup [ ] getChildren ( ) 

Get the list of the children of this group may consists of 
different groups. 

j ava . util . LinkedList getKeywords ( ) 

15 

j ava . lang . String getName ( ) 

Get value of the name attribute. 

java . util . Properties getProperties ( ) 
20 This method returns this group' s properties as they appear in 
XTRF. 

java. util .Map getRequiredClasses ( ) 

this method returns map that containes pairs of the form: 
25 requiredclass name - its source. 

java. lang. String getSource() 

This method returns source of this test group. 

30 Inherited Member Summary 

Methods inherited from class Object 
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clone (), equals (Object ) , finalize (), getClassO, hashCode ( ) , 
notify (), notif yAll ( ) , toString ( ) , wait ( ) , wait () , wait ( ) 

Fields 
5 attributesMap 

protected j ava . util . Map attributesMap 
el 

protected com. sun . xtrf . parser . Element el 
Current node in the parsed tree. 
10 Keywords 

protected j ava . util . LinkedList keywords 
parser 

protected com. sun . xtrf . parser . XTRFParser parser 
15 instance of the class that handles parsing 

Constructors 
TestGroup ( ) 
public TestGroup ( ) 

20 

Methods 

addTagHandler (String, TagHandler ) 

public void addTagHandler ( j ava . lang . String tagName, 
25 com. sun . xtrf . parser . TagHandler handler) 

allows adding xml tag and class that handles it to the parser 

getChildren ( ) 

30 public com. sun . xtrf . parser . TestGroup [ ] getChildren ( ) 
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Get the list of the children of this group may consists of 
different groups 

getKeywords ( ) 

5 

public j ava . util . LinkedList getKeywords ( ) 
getName ( ) 

10 public java. lang. String getName ( ) 
get value of the name attribute 

getProperties ( ) 

15 public java . util . Properties getProperties ( ) 

This method returns this group's properties as they appear in 
XTRF. 

Returns: properties of this test group. If there are no 
properties returns null* 

20 

getRequiredClasses ( ) 

public java. util. Map getRequiredClasses ( ) 

This method returns map that containes pairs of the form: 
requiredclass name - its source 
2 5 get Source ( ) 

public java. lang. String getSourceO 

This method returns source of this test group. 

Returns: source of this group null if there is.no source 



30 

TestPackage 
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Declaration 

public class TestPackage extends TestGroup 

j ava . lang . Ob j ect 

I 

5 + — com . sun . xtrf . parser . TestGroup 
I 

+ — com. sun . xtrf . parser . TestPackage 
Description 

TestPackage object embodies the name of the testpackage and 
10 needed information The list of the objects is extracted from 
XTRF format files by the appropriate XML parser (files that 
contain all necessary information about test parameters and 
execution in XML format) 

15 Inherited Member Summary 

Fields inherited from class TestGroup 
attributesMap, el, keywords, parser 

Methods inherited from class Object 
20 clone ('), equals (Ob j ect ) , finalize (), getClass(), hashCode ( ) , 
notify (), notifyAll(), toString ( ) , wait () , wait ( ) , wait ( ) 

Methods inherited from class TestGroup 
addTagHandler (String, TagHandler) , getChildren ( ) , 
25 getKeywords ( ) , getName ( ) , get Properties () , 
getRequiredClasses ( ) , getSource ( ) 

TestSuite 
Declaration 

30 public class TestSuite extends TestGroup- 
j ava . lang . Ob j ect 
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I 

+ — com. sun. xtrf . parser . TestGroup 
I 

+ — com. sun . xtrf . parser . Test Suite 

5 

Description 

TestSuite object embody the name of the testsuite and 
information about its children The list of the objects is 
extracted from XTRF format files by the appropriate XML 
10 parser (files that contain all necessary information about test 
parameters and execution in XML format) . 

Inherited Member Summary 
Fields inherited from class TestGroup 
15 attributesMap, el, keywords, parser 

Methods inherited from class Object 

clone (), equals (Obj ect) , finalize (), getClass(), hashCode ( ) , 
notify (), notifyAll(), toString ( ) , wait ( ) , wait ( ) , wait ( ) 

20 

Methods inherited from class TestGroup 
addTagHandler (String, TagHandler) , getChildren ( ) , 
getKeywords ( ) , getName ( ) , getProperties ( ) , 
getRequiredClasses ( ) , getSource ( ) 

25 

XtrfApi 
■ Declaration 
public class XtrfApi 
30 java. lang. Object 
I 
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• +--com. sun. xtrf . parser . XtrfApi 
Description 

This is an api class for xtrf parser contains methods that 
5 allow user to use this parser as a stand-alone application. 



Member Summary 
Constructors 
10 XtrfApi () 

Methods 
static 

java . lang. String 
15 getLocation ( ) 

TestGroup getRoot (java. io. File file) 
get root element of xtrf file 
void init ( ) 

load tag and attributes handlers 

20 

void setLocation (java. lang. String location) 
sets physical location of xtrf format files 

Inherited Member Summary 
25 Methods inherited from class Object 

clone () , equals (Object) , finalize (), getClass(), hashCode ( ) , 
notify (), notif yAll ( ) , toString ( ) , wait ( ) , wait ( ) , wait() 

Constructors 
30 XtrfApi () 

public XtrfApi () 



P9309 



47858 



Ver. 47858S6.doc 



65 



Methods 
getLocation ( ) 

5 public static j ava. lang . String getLocation ( ) 

getRoot (File) 

public com. sun . xtrf . parser . TestGroup getRoot ( j ava . io . File f ile ) 

10 

get root element of xtrf file 
init() 

15 public void init ( ) 

load tag and attributes handlers 

setLocation (String) 

20 public void setLocation ( j ava . lang . String location) 
sets physical location of xtrf format files 



P9309 



